home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / winhv20.zip / WINHV.DOC < prev    next >
Text File  |  1991-07-24  |  11KB  |  329 lines
  1. Dave Lord's  
  2.     Win Hex View    Version 2.0
  3.  
  4.     
  5.     This program is distributed as shareware. You may make copies of it
  6.     for evaluation and distribution but if you like the program you should
  7.     register it. The cost is $15. If you register before the end of 1991
  8.     I will send you a copy of the successor to this program when it is
  9.     complete (expected around the end of Sept. 1991). That program,
  10.     tentatively titled "Gander" will be a text and binary file viewer
  11.     along the lines of the DOS program "LIST". Also if you register
  12.     by the end of 1991 I will consider your registration fee to also
  13.     cover the registration for "Gander". Anyone who has ideas of what
  14.     they would like to see in this new program should write me ASAP.
  15.     
  16.     This program may be freely distributed. It may not be sold.
  17.     A nominal copying charge may be made not to exceed US $10.
  18.     
  19.     
  20. Registrations outside of the US:
  21. --------------------------------
  22.     Unfortunately it is virtually imposible within the US to exchange
  23.     small amounts of foreign currency or to cash checks drawn on foreign
  24.     banks. If you can't send US money I will accept CD or cassettes of
  25.     any music you think will not be generally available in the US.
  26.     Generally we get the most popular Brittish groups and that's about
  27.     it. We don't even get much Canadian music. My tastes are eclectic,
  28.     anything from traditional to modern. How about if one of you Canadians
  29.     sends me some "Doug and the Slugs", eh?
  30.  
  31. Copyright c 1991 by Dave Lord
  32.  
  33.     Dave Lord
  34.     3307 Lincoln Av.
  35.     San Diego, CA 92104
  36.  
  37.     Internet: davel@pnet03.cts.com
  38.  
  39. This program is distributed as is. The author assumes no liability for any 
  40. dammages resulting from its use.
  41.  
  42.  
  43.  
  44.         
  45. Description of program
  46. ----------------------
  47.     
  48.     WINHV is a Windows 3.0 program which will allow you to view and print
  49.     files in hexidecimal form with the ascii (text) equivalent 
  50.     displayed alongside. You can also view items from the clipboard.
  51.     
  52.     WINHV provides string search, hex search and the 
  53.     ability to jump to a specific character or record, records 
  54.     being defined by a user selectable end of record mark which 
  55.     defaults to 0xa (linefeed).
  56.  
  57.     You should have these files:
  58.  
  59.         WINHV.EXE        the executable
  60.         WINHV.HLP       the help file
  61.         WINHV.DOC       this file
  62.         WINHV.INI        preferences file
  63.         REGISTER.TXT    registration form
  64.         
  65.         
  66.     
  67. History
  68. -------
  69.  
  70.     2.0    I can now always find the help file if it is in the same
  71.         directory as the executable.
  72.  
  73.         Save preferences to WINHV.INI. 
  74.  
  75.         Increased the speed at which the screen is displayed.
  76.  
  77.         Added Hex search.
  78.  
  79.         Improved the usability of Search.
  80.  
  81.         Added Hex/Dec Converter.
  82.  
  83.         Added ability to view clipboard.
  84.  
  85.         Shrink the title when program is iconized.
  86.  
  87.         Display logo on startup.
  88.  
  89.         Added Print option.
  90.  
  91.         Handle multi-megabyte files. Previously the scrollbars
  92.         went to lunch on a 500k file. Now tested up to 3.5Meg.
  93.         A word of warning, it can take several minutes to Search
  94.         through a file of that size and Search can't be interupted.
  95.  
  96.  
  97.     1.1    This release was primarily to fix some bugs I introduced
  98.         into version 1.0 at pretty much the last minute. Most of
  99.         them related to using the side-to-side scroll bar. 
  100.  
  101.         I made a couple of changes to the open dialog. First, when
  102.         you enter a wildcard file spec I remember it even when you
  103.         change directories. Second, if you click "cancel" I no 
  104.         longer shut down the previous file.
  105.  
  106.         I fixed the dialog boxes so that you can tab through the
  107.         controls.
  108.  
  109.         And for those of us poor "vi" users whose fingers are
  110.         hopelessly programmed to type j, k, l, and h when they
  111.         want to move around on the screen, I now accept the following
  112.         "vi" commands: j, k, l, h, ^F, ^B, G, /, n, N. They act
  113.         almost as you would expect except that l and h move
  114.         sideways a whole page rather than a single character, and
  115.         n and N always operate forward and reverse regardless of the
  116.         direction of the original search. Oh and / is only a string
  117.         search. Regular expression search is still to come.
  118.  
  119.  
  120.     1.0    Initial release.
  121.  
  122.  
  123.  
  124. Using the program
  125. -----------------    
  126.  
  127.     If you know how to use other Windows programs then you shouldn't
  128.     have any trouble with this one. You can start it from the program
  129.     manager as an icon or with the Run command. If you start it with
  130.     the Run command you can specify the file to view on the command
  131.     line. You can view a new file by clicking on File and Open.
  132.     
  133.         
  134.     
  135.     
  136. Menus:
  137. ------
  138.  
  139. Ansi Charset
  140.  
  141.     Selecting this menu item causes the Ascii Text portion of the 
  142.     screen (the right-hand side) to display text using the Ansi 
  143.     character set. This is the extended Ascii Character set normally 
  144.     used by Windows. 
  145.  
  146.  
  147.  
  148. IBM PC Charset
  149.  
  150.     Selecting this menu item causes the Ascii Text portion of the 
  151.     screen (the right-hand side) to display text using the extended 
  152.     Ascii Character set used by the IBM PC under DOS.  
  153.  
  154.  
  155.  
  156. Ascii Text Charset
  157.  
  158.     Selecting this menu item causes the Ascii Text portion of the screen 
  159.     (the right-hand side) to display text using only the basic Ascii Text 
  160.     Characters.  All other characters are displayed as grey boxes.  
  161.     
  162.     For the purposes of this program Ascii Text Characters are the 
  163.     characters from 0x20 through 0x7e
  164.  
  165.  
  166. Open File
  167.  
  168.     Allows you to select a file to view. The open dialog works pretty 
  169.     much the same as in nearly every other Windows Program.
  170.  
  171.  
  172. Open Clipboard
  173.  
  174.     Allows you to view an item from the clipboard. Clipboard items 
  175.     are stored on a variety of formats, Hex View allows you to view 
  176.     the predefined formats: BITMAP, DIB, DIF, METAFILEPICT, 
  177.     OEMTEXT, PALETTE, SYLK, and TIFF.  Some programs may 
  178.     also use private formats which I don't support. In theory the 
  179.     clipboard can hold several items simultaneously as long as each 
  180.     is in a different format. In practice this is rarely done. 
  181.  
  182.     For each of the above formats except METAFILEPICT and 
  183.     BITMAP what I display is simply the contents of the global 
  184.     memory block retrieved from the clipboard.  
  185.  
  186.     For METAFILEPICT I show the METAFILEPICT structure 
  187.     followed by the Metafile itself (starting at 0x10). 
  188.  
  189.     For BITMAP I show the BITMAP structure followed by the 
  190.     Bitmap bits (starting at 0x10).
  191.  
  192.  
  193. Print
  194.  
  195.     Allows you to print all or part of the file. In the dialog box
  196.     select All or From / To. The default for From / To is to print
  197.     what is on the screen but you can set your choice of From and To
  198.     locations. Values are byte offsets into the file specified in hex.
  199.  
  200.  
  201.  
  202. Find
  203.  
  204.     Allows you to search for a character string within the file you are 
  205.     viewing.  The string may be specified as text characters (a, b, c, etc.) 
  206.     or as hex (41,  0a, ff). Enter the string and choose whether it is a 
  207.     string search (text) or a hex search. If it's a string search, choose 
  208.     whether uppercase and  lowercase characters should match, then press 
  209.     Forward or Reverse. 
  210.  
  211.     If there is highlighted text on the screen then Forward searches 
  212.     will start immediately following the highlighted text, otherwise 
  213.     the search will start with start with the first character on the 
  214.     screen, backwards searches start before any highlighted text on the 
  215.     screen, or with the character preceding the first one on the screen.  
  216.     The string is highlighted on the screen when it is found.
  217.  
  218.     Repeat a search using Repeat Forward or Repeat Back.
  219.  
  220.  
  221.  
  222.  
  223. Jump
  224.  
  225.     This allows you to jump to a particular character or record in the file.
  226.  
  227.     Enter a number, select decimal or hex, select character or record and 
  228.     press OK.
  229.  
  230.     Characters are found by simply counting from the beginning of the file 
  231.     (starting at 0 of course).
  232.  
  233.     Records are found by counting Record Markers.  You can chose the 
  234.     record marker by entering the hex value of the character which marks the 
  235.     end of a record. The default is 0xa (Linefeed).
  236.  
  237.  
  238. Hex/Dec Converter
  239.  
  240.     The Hex/Dec Converter allows you to quickly convert numbers to and 
  241.     from hex, decimal, and binary. 
  242.     
  243.     The converter contains three edit boxes, one each for hex, decimal, and 
  244.     binary. Simply select the one you want with the mouse, enter a number in 
  245.     the appropriate form, and the number will apear converted to the other 
  246.     forms in the other two boxes. Converting the hex number to and from Little
  247.     Endian form is left as an exercise for the user.
  248.  
  249.     The converter is a modeless dialog box so you can leave it on the screen 
  250.     while you use Hex View.
  251.  
  252.  
  253. Keyboard
  254. --------
  255.  
  256. Shortcut Keys
  257.  
  258.     <down arrow>    Down one line.
  259.     <up arrow>        Up one line.
  260.     <left arrow>    Left a page.
  261.     <right arrow>    Right a page.
  262.     <page up>        Page up.
  263.     <page down>        Page down.
  264.     <home>        Begining of file.
  265.     <end>        End of file.
  266.     Shift + F3        Search.
  267.     F3            Repeat forward.
  268.     F4            Repeat backward.
  269.     Ctrl + F3        Jump
  270.     Shift + F5        Hex / Dec Converter
  271.      
  272.  
  273.  
  274. 'vi' User's Keystrokes
  275.  
  276.     In Windows 3.0 the standard is to use control - alt - shift - function key 
  277.     combinations as shortcut keys. I can only assume that Microsoft was 
  278.     trying to emulate the one feature of WordPerfect that everyone really 
  279.     hates. Anyway, I provided those, but I also provided shortcut keys based 
  280.     on the one true keyboard interface: vi.
  281.  
  282.     j    Down one line.
  283.     k    Up one line.
  284.     h    Left. OK I cheated, it's Left a whole page.
  285.     l    Right. Again, a whole page.
  286.     ^F    Down a page.
  287.     ^B    Up a page.
  288.     ^U    Up half a page.
  289.     ^D    Down half a page.
  290.     /    Search.
  291.     n    Repeat search Forward.
  292.     N    Repeat search Backward.
  293.     G    Go to End.
  294.     :    Jump. Really. Think about it. (While ':' serves other
  295.         purposes in 'vi', :<number> jumps to a line).
  296.  
  297.  
  298. Saving Preferences
  299. ------------------
  300.  
  301.     This program saves a number of options in winhv.ini. winhv.ini should be 
  302.     in the same directory as winhv.exe. If winhv.ini is missing the program 
  303.     will  not recreate it, if you want it back you should create it as an 
  304.     empty file  using an editor, the next time you run winhv.exe it will 
  305.     get updated.
  306.     
  307.     The following options get saved to winhv.ini:
  308.  
  309.     Charset
  310.     Last search string
  311.     Last search type (string or hex)
  312.     Jump type (decimal or hex)
  313.     Ignore Case (on search)
  314.  
  315.     
  316. Non-English character sets
  317. --------------------------
  318.  
  319.     I don't support any character set using more than one byte per
  320.     character (such as Kanji). Most others I should handle OK (even
  321.     the case conversion on the string search). If your character set
  322.     uses characters outside the range ' ' .. '~' you'll probably
  323.     want to pop up the Charset menu and select either IBM-PC or
  324.     Ansi. Starting with release 2.0 I will save your choice of
  325.     Charset in WINHV.INI.
  326.     
  327.     
  328. -- WINHV.DOC   Copyright 1991 by Dave Lord
  329.